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DECmate IT: 
Word Processing 


Learning the Basics 


Word Processing Primer 


Teaches you word pro- 
cessing basics such as 
creating, editing, print- 
ing and copying docu- 
ments using a quick, 
step-by-step format. This 
manual also tells you 
where to go next and 
what to do if you have 
problems with DECmate. 


Introduction to 
Word Processing 


Teaches you basic word 
processing: how to create, 
edit and print docu- 
ments. This self-paced 
course contains two disk- 
ettes (Introduction to 
WPS—-Drive 0 and Intro- 
duction to WPS—Drive 1) 
and a card to get started. 


Getting Started 
Getting Started Card 


The System Overview 


Teaches you how to iden- 
tify the system parts, 
and handle diskettes. 
This self-paced course 
contains one diskette. 
Read Chapter 6, Using 
the System Overview 
Diskette, in the 
DECmate IT Installation 
Guide (order number 
EK-—DECM2-IN) to be- 
gin the course. 


Teaches you how to turn 
ON your word processing 
system, activate features, 
initialize a document 
diskette, and back up the 
system diskette. It also 
tells you who and when 
to call for help. 


Reference 


User’s Guide: 
Volumes 1 & 2 


Explains DECmate II 
word processing proce- 
dures. Volume 1 contains 
basic word processing 
tasks: how to create, edit 
and print documents. 
Volume 2 contains 
advanced word process- 
ing tasks such as pagina- 
tion, text manipulation, 
document searches and 
control commands. 


Quick Lookup Guide 


Summarizes basic word 
processing procedures. 
This guide is organized 
by tasks, such as creat- 
ing or printing text. If 
you are an experienced 
user, read this guide 

to review basic word 
processing. 


Note: You should be 
familiar with basic word 
processing procedures before 
using the optional features. 


Optional Features 
Using List Processing 


Using Communications 


Teaches you how to use 
Communications. Com- 
munications lets you 
send information to and 
receive information from 
other computer systems. 


Using Math 


Teaches you how to use 

Math. Math lets you do 

arithmetic while editing 
documents or using List 
Processing. 


Teaches you how to use 
List Processing. List 
Processing lets you print 
the same document (such 
as a form letter) many 
times, varying certain 
information from copy to 
copy. 


Using Sort 


Teaches you how to use 
Sort. Sort lets you 
arrange lists of informa- 
tion in alphabetical or 
numerical order. 
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Preface 


PRODUCT NAME: DECmate II/WPS 
VERSION: 1.0 


This manual explains how to operate the optional DECmate ™ IT Word 
Processing Sort feature. Use Sort to arrange records in a list document in 
the alphabetic and/or numeric order you specify. 


Intended Audience 


To use Sort, you should be familiar with DECmate word processing and list 
processing. No prior experience with Sort is necessary. 


How ito Use This Manual 


To learn Sort, follow the examples, exercises, and step-by-step procedures in 
this manual. A glossary of terms associated with Sort is included. 


NOTE: The examples and exercises are drawn from Digital Equipment 
Corporation’s DECdirect catalogue, and they are not statements of DIGITAL’s 
prices or policies. 


Vil 


Preface 


Conventions 


Dot Matrix Text printed in dot matrix appears on the screen. 


<field name> ‘Text inside angle brackets is a field name for List Process- 
ing, Sort, or Math. 


Rubout key The key marked with a symbol used to rub out 
functions. 


Word 
<x) Char 


ALL CAPS The function or editing key to press. 
For example: press ADVANCE. 
Gold XXX Press the Gold key and then a function key. 
For example: Gold MENU. 
Type Enter text into a document from the keyboard. 
Press Enter a command from the keyboard. 


For example: press DEL WORD. 
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Overview 


To Use Sort Quickly: 


Check the Main Menu (8rd page) for the SR option. 
Activate Sort, if necessary. 


Create the input document, containing the list of information to 
sort. If you already have the input document, note its name or 
number. 


Create the sort specification. 
Select Sort Option (SR) from the Main Menu. 


Type the name or number of the sort specification document and 
press RETURN. 


Type the name or number of the input document and press 
RETURN. 


Type the name or number of the output document and press 
RETURN. 


Type GO to begin Sort. 
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Overview 


What to Do with Sort 


Use Sort to organize records to your particular order. You can sort with as 
many as twelve different keys or fields in a record. (A key or field identifies 
a specific kind of information.) 


You can organize records in a list document into ascending or descending 
alphabetical and/or numerical order on one or more keys or fields in each 
record. 


For example, some of the keys on which you might sort a list of customer 
records are: 


Last name, city, state, zip, debits, credits, item numbers, and inventory 
numbers. 


To save money on postage, for example, you could sort on zip codes, then use 
List Processing to print letters to a specified zip code. 


Or, you might sort on customers’ last names to have an alphabetical file. 
Then, you might add new customer records to the file and re-sort the list to 
put the records in a new sequence. 


Major Parts of Sort 


e Activate Sort on the system diskette. (Once activated, it is not neces- 
sary to activate it again on that system diskette.) See Chapter 2. 


e §=6An input document that contains the information to be organized. 
(For example, a List Processing list document.) See Chapter 3. 


e 6A sort specification document that contains the instructions to 
organize the input document. See Chapter 4. 


e An output document that contains the reorganized list. See 
Chapter 5. 
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Overview 


The Sort Alphabet 


You use Sort to put input document records into an ascending or descending 
order by specifying the keys or fields on which you want DECmate to sort 
those records. DECmate puts the records in the order you decide by compar- 
ing characters in the field values of the specified keys with the order of 
those characters in the Sort Alphabet. 


Ascending order starts with the lowest value in the Sort Alphabet and con- 
tinues to the highest. Descending order starts with the highest value and 
continues to the lowest. The symbols @ and ~ have the lowest value; the 
punctuation mark ? has the highest value. Letters, numerals, other symbols 
and punctuation marks come between. 


The complete Sort Alphabet is on the next page. 


Overview 


Value Char. Comment Value Char. Comment 
91 @* gaveisonHALT key 92 © underline = I @,~ grave is on HALT key 4 - underline 
oO 2 A,a 33 space 
G 3 B, b 34 ! exclamation point 
= * 2 35 . quotation mark 
5 D,d 36 # number sign 
6 E,e 37 $ dollar sign 
7 Ff 38 % percent sign 
8 G, g 39 & ampersand 
9 H,h 40 ; apostrophe 
10 lL; i 41 ( open parenthesis 
Ml J, j 42 ) close parenthesis 
12 K,k 43 * asterisk 
13 L, | 44 + plus sign 
14 M,m 45 ; comma 
15 N,n 46 ~ hyphen or minus sign 
16 O, 0 A7 period 
17 P, p 48 / slash 
18 Q,q 49 0 
19 Lay 50 1 
20 S,s 51 2 
21 1,% 52 3 
22 UU. & 53 4 
23 ¥¥ 54 5 
24 W,w 55 6 
25 A, x 56 7 
26 ¥,¥ 57 8 
27 Z, Z 58 9 
28 [yt left bracket /brace 59 colon 
29 X, | backslash, vert. line 60 semicolon 
30 1, } right bracket /brace 61 = equal sign 
31 . circumflex, tilde 62 ? question mark 


Figure 1. Sort Alphabet 
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Activating Sort 


You must activate Sort on your system diskette before it can be used. Once 
activated, Sort is active for the life of the system diskette. 


To activate Sort, you need two diskettes: 
1 The Sort feature diskette labeled WPS SORT RX50. 
2 Asystem diskette labeled WPS THE BASICS RX50. 


Is Sort Already Active? 


Sort may already be active on the system diskette. To check whether it is or 
not, display the Diskette Maintenance Menu (see Figure 2). 


Select MC from the Main Menu. 


Activating Sort 


DISKETTE MAINTENANCE MENU SLLO/ 82 Fri 2:o0:23 


= Activate ortional features 
= Make BACK UP copy of your diskette 
Copy document 


= Initialize a document diskette 


mon & Dd 
il 


= Initialize a system diskette 


Wo = Verify diskette structure 
Type the letter(s) and then press RETURN 


OR Press Gold MENU to recall the Main Menu, 


Figure 2. Diskette Maintenance Menu 


Now, select the A option and press RETURN. The Activate Features Menu 
appears. (See Figure 3.) This menu shows which optional features are active 
on the system diskette. 


If Active appears before Sort Option, Sort is active. Press Gold MENU to 
recall the Main Menu. 


If Not Active appears before Sort Option, activate the feature, as explained 
in the next section. 


NOTE: Your display may differ from the one shown in Figure 3, if other 
optional features are active. 


Activating Sort 


--ACTIVATE FEATURES MENU-- wi iO/G2 Fri 2351:35 


The following optional features are available on your diskette: 


STATUS FEATURE 

Active Basic Word Processing 
Not Active Communications Option 

Active List Processing Ortion 
Not Active Sort Option 
Not Active Math Option 


To activate an optional feature+ Place the aprrorpriate 
FEATURE diskette into Drive 1 and press RETURN: or 
Press Gold MENU to recall the Main Menu, 


Figure 3. Activate Features Menu 


To Activate Sort 
While the Activate Features Menu is displayed: 


1 Leave your system diskette in drive 0. 
2 Remove any diskette in drive 1. 


3 Put the Sort feature diskette in drive 1. Make sure the red arrow 
on the diskette lines up with the red mark on drive 1. 


4 Close both drive doors. 


5 Press RETURN. 


Activating Sort 


DECmate automatically checks drive 1 to make sure it contains a feature 


diskette. If it does, DECmate activates Sort, while displaying this message: 


-~- Activating Special Feature Option -- 


Activation in Progress, Please Stand by «oe, 


The automatic check and the activating process take less than a minute. 
During this time, noises come from the diskette drive unit. When the 

activating process is complete, the Activate Features Menu reappears, show- 
ing Sort as Active. (See Figure 4.) 


Figure 4 Sort Activated 


Press Gold MENU to return to the Main Menu. The Sort Option (SR) 
should appear on page 3 of the Main Menu. Remember to remove the Sort 
feature diskette from drive 1 before doing word processing. 


NOTE: After the optional feature has been activated, make a copy of the sys- 


tem diskette. 
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Activating Sort 


lf Sort Does Not Activate 


Make sure you are using the diskette for the Sort option. One of the follow- 
ing system messages may appear during the activation process: 


Drive 1 does not contain a valid FEATURE diskette, 


The wrong diskette is in drive 1, such as a damaged feature diskette or a 
document diskette. 


Press RETURN to recall the Activate Features Menu. Put the correct fea- 
ture diskette in drive 1 and press RETURN. 


Error on drive 1 while trying to read block (number), 


An error developed while the activating process was taking place. The drive 
door might not be securely closed, or the drive cannot read the feature 
diskette. 


Check the drive doors to make sure they are securely closed. You cannot 
verify the feature diskette. 


If the feature still does not activate, there may be a problem with 
DECmate II. (See DECmate IT Owner’s Manual, EK-DECM2-—0OM.) 


NOTE: To use Sort with either List Processing or Math, those features must 
be active on your system diskette. 


; Input D t 

a Pp 

amm 

es The input document has the information you want to sort and is organized 

| by records. One kind of input document is the list document used in List 

jaa Processing. (The same document is often both a Sort input document and a 

_ List Processing list document.) Sort does not change the input document. 

~ Records 

roy The input document consists of records. Each record contains information 

* about one person or thing. For example, if the input document is a person- 

rome nel file, there should be a separate record for each employee. Similarly, if 

. the input document is an inventory list, there should be a separate record 

— for each item in the inventory. 

on, Each record must end with a diamond <> followed by two RETURNS. (A 
diamond is made by typing a left angle bracket <, then a right angle 

_ bracket >.) The <> marks the end of one record and the beginning of the 

next. Each record is made up of fields. The first record is all of the fields 

_ before the first <>. Other records are the fields between two consecutive 
diamonds. To move forward through the records, press ADVANCE and then 

a the PARA key. To move backward, press BACK UP and then the PARA 
key. 

NOTE: A single record can have as many as 2500 characters. An input 

a document can have as many as 4000 records. 


Inout Document 


Fields 


A record has one or more fields, and may have up to 2500 characters. Use 
Sort to rearrange a list of records on a specified field. A field consists of the 
field name typed between left < and right angle brackets > and the field 
value that is typed immediately after the right angle bracket >. Each field 


name must be on a separate line. 


The following is an example of a list of records: 


<lastoKadis 
Cfirst>Freeman 
€corSine Qua 

<add>155 Fourth Avenue 
<city Vestal 

<state ony 

€zip?13850 
Ccat#>oF-LOPO1-KA 
<Pg#H13 

<item#> 0074 
<descrip?Mylar Ribbon 
<shipPping wt?>1 lb, 
<runit Price?42,00 
<Paymt>cash 

{> 


<last>Spell 
<first>Sarah 
<corProductions Ltd. 
<add>175 Inwood Avenue 
<city NY 

<state Ny 

<zip>10034 
<cat#>F-HO8S50-PH 
<pg#>14 

<item#>TOO74 
<descrip>Fanfold Paper 
<shipPingdg wt>27 lbs. 
<tunit Price>43,00 
<Paymt> credit 

<> 
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<last?Robertson 
<firstoWilliam 
<cos+Survivorss Inc. 
€<add>910 Hedge Road 
<citysCampbell 
<state>sCA 

<Zip>95008 
<cat#>F-LOPK2-SW 
<pg#>19 

<item#>AQO7G 
«descrip?sAcoustic Cover 
<shippPing wt?40 lbs. 
Csunit Price>425,00 
<Paymt>COD 


? 


4+ 


<last>Brindel 
<first?Robert 
<co>Span Arch» Inc- 
€add>159 Colby Street 
<citysNashua 
<state>NH 

€Z1P203063 
<cat#>F-HOBSO0-RL 
<PIHOZ7 

<item#>3009 
<descrip?WP rulers - pKg, 
<shipPing wt?.05 lbs 
<sunit Price>+$20,00 
<Paymt-ecash 

<> 


<last>Emery 
<first?Charles 
<coseCompPputaumations Ine. 
<add>608 Knoll Road 
<cityeManchester 
<state?NH 

€zZip?03101 
<cat#>F-HOB50-DA 
<Pg#>40 

<item#s/008 
<descrip>DECmat 4’x6’ 
<shipPing wt310 lbs, 
<tunit Price?125.00 
<Paymtocredit 

<> 
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Inout Document 


¢last?Maclean 
<firstsRoxanne 
<corBasics:s Ltd. 
<add>3708 Loam Avenue 
«city >+Anaheim 
<state+CaA 

€zip?92803 

<cat#>F -H9B8S0-EB 
{Pg#>26 

<item#>8976 
¢<descrip?Serial Interface Switch 
{shipping wt>2 lbs. 
<runit Price?235,.00 
<paymt>COD 


4? 


Figure 5 Example Format of Records and Fields 


Field Names 


Decide what to name each field. Use a descriptive field name, such as 
<last> for last name, to identify information. Remember, short field names 
use less diskette space. 


e Begin each field name on a new line. 


e Begin each field name with a left angle bracket <. End each field 
name with a right angle bracket >. 


NOTE: Use angle brackets only to mark the beginning and end of 
every field name. 


¢ Do not begin a field name with an exclamation point (!). 
e Do not make field names more than 30 characters long. 


e Type field names exactly the same way in each record. Use the same 
letters, capitalization, spaces, and punctuation every time you use 
the same field name. 
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Field Values 


The field value is the content that goes with a specific field name. 


e Each field value begins immediately after the right angle bracket > 
of the field name. Spaces and other invisible characters after the 
right angle bracket affect the sort of all but numeric fields. 


e Each field value ends with a RETURN before the next <. If spaces 
occur before the RETURN, they are considered part of the field 
value. 


e A diamond <> marks the end of the last field value in a record. 


e To sort on any particular field, it must have a field name and a field 
value. For example, you could have an address with the field name 
and field value as: 


€<add>G0O8 Knoll Road 
Manchesters NH O3101 


But, in this example, you could sort only on the address field as a 
whole. If, in the future, you wanted to sort on zip codes, you would 
have to edit your input document list to include: 


4zZip2O03101 


See Figure 5 as an example of creating a list that can sort on many 
different fields/keys. 


Empty and Missing Fields 


Sometimes, you do not have all the information needed to complete a record. 
For instance, you may not know the name of the state in a mailing address. 


An empty field contains a field name, such as <state>, but no field value, 
such as Vermont. A missing field has neither a field name nor a field value. 
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Inout Document 


The sort field or sort key is the field on which a record is sorted. Records 
sorted on empty or missing fields are grouped either at the end or the begin- 
ning of the output document. An ascending Sort lists records with empty or 
missing fields at the end of the output document. A descending sort lists 
records with empty or missing fields in the beginning of the output 
document. 


NOTE: A field value that has only spaces (entered with the space bar or TAB 
key) is not an empty field. The field value may appear empty on the screen or 
when printed. When the field value is sorted, however, the field is ordered 
according to the value given to a space in the Sort Alphabet. 


Numeric Fields 


Numeric fields have field names that always begin with a colon : and field 
values that are numeric. Use numeric fields in Sort to arrange field values 
according to their numeric values. Numeric fields are used in List Process- 
ing to test for numeric values. (See Using List Processing, AA—N183A-TA.) 
With List Processing Math, you do math calculations on numeric fields. (See 
Using Math, AA-N186A-TA.) 


Not all fields that contain numbers have numeric value. For instance, field 
names such as zip codes, street addresses, and dates have field values that 
are numbers. Such fields, however, do not have numeric field values, unless 
the numbers appear after a numeric field name. 


Numeric Field Names. To use numeric values in the list, type a colon: 
before a field name. Note the use of the colon : to define the numeric field 
name, <:unit price>, in Figure 5. 


Numeric Field Values. 


e Only these characters are valid as numeric field values: 
$()*+,-.01234567890 


NOTE: Sort Alphabet characters—other than those listed above—are 
considered errors in a numeric Sort; and Sort stops if it finds an 
invalid numeric field. DECmate ignores all characters after a space 
in a numeric field value. 
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Inout Document 


Each numeric field value must have not more than 138 valid 
characters. 


Numeric field values with decimal points must have not more than 
six characters after the decimal point. (Example: 13.365785) 


Some symbols in the numeric field value are valid only in certain 
positions. 


The characters $ * + (). appear no more than once. 
The characters § * + ( appear at the beginning. 
The character ) appears at the end. 

The + sign comes first, if it appears. 

The — sign is either first or last, if it appears. 


The $ sign comes before the * and after any of the characters ( + 
or —. 


There is one ) for every (. 


The characters () and the — sign do not appear in the same field 
value. 


There are no empty pairs of parentheses. 


Use commas , as numeric separators. 


Use Sort to order the numbers in a numeric field according to their numeric 
field values. Here is an example of two lists sorted on one key in ascending 
order. One list has a numeric field name and the other list does not. 


Numeric Field Non-Numeric 
<:unit price>—/9,00 <unit price> + 79.00 
<> <> 
<:unit price>7.90 <unit price>—79.00 
<> <> 


<:unit price> + 79.00 <unit price>7.90 


<> 


<> 
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Other Facts About Inout Documents 


An input document is any document that has been formatted with field 
names and field values. It is created, edited and printed in the same way as 
any other document. Control commands and invisible characters can be 
included. 


Rulers 


Use only one ruler in the input document. If Sort finds another ruler in the 
input document, the following message appears on the screen: 


Warning - List contains multiple rulers 


This is an informational message, and does not stop the Sort. Sort ignores 
additional rulers. Only the first ruler in the input document determines the 
format of the output document. This ruler should be set before your first 
record. 


NOTE: If you need multiple rulers in the sorted list, you should edit the out- 
put document to be sure you put the rulers where you want them. 


Control Command Markers 


You may wish to type a paragraph or two in the input document to alert 
another user editing the list. This note may describe the purpose of the list, 
the field names used, or any other necessary information. Place any text, 
not part of a record, before the first record at the beginning of the input 
document. 


To include text that is not part of a record: 


1 Press Gold CMND. DECmate inserts a START CONTROL marker. 
2 Type the word COMMENT and then press RETURN. 
3 Type the text you wish to insert and press RETURN. 


4 Press Gold CMND. DECmate inserts an END CONTROL marker. 


7: 


J 


ee ee ee ee es ee ee 


Se ee 


I 


J do) i941 9~«*'7 
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Text placed between control command markers with the keyword 
COMMENT appears in the output list; it does not appear if the input or 
output document is printed. 


NOTE: Be sure to insert the START CONTROL marker at the very top of 
the document. 


Exercise 1: Create an Input Document 


To help you learn Sort, complete the exercises that appear at the end of 
Chapters 3, 4, and 5. For this first exercise, create an input document. Put 
this document on an initialized diskette. The input document you create will 
look similar to the input list in this chapter. But, your input document will 
have 9 fields; not 14 fields. 


1 Create the input document and name it Customer List. 
2 Type the following fields into your input document: 


<last> 
<first> 

<add> 

<city> 
<state> 

<ZiP> 

<item > 
<tunit Price> 
<Paymt > 

<> 


(Press RETURN twice after typing the diamond <>.) 


3 You will need six records for this exercise. To avoid typing the field 
names five more times, try the following: 


Press BACK UP, PARA, SEL, PARA, Gold CUT. 
Press PASTE five times. You will have 6 records with field names 
only. 
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4 Place your cursor at the top of the input document. Use ADVANCE 


<> to move the cursor to the end of each field name. Fill in the 
information so that your records look exactly like this: 


<lastoKadis 
<firstoF reeman 


€add>155 Fourth Avenue 


<city>Vestal 
<statescNy 
€zip>13850 

<item#> 0074 
<runit Price>+d2,.,00 
<Paymtecash 

<> 


<last?>Sprell 
<firstoSarah 


€<add>175 Inwood Avenue 


<city>NyY 

<state Ny 
€zip?10034 
<item#>TOO74 
€runit Price?43.00 
<Paymt?> credit 


, 


<> 


<last>Robertson 
<firsteWilliam 
fadd°910 Hedge Road 
<citysCampbell 
<state>CA 
<z1P>95008 
<item#>A0O7G 

Crunit Price?425,.00 
<Paymt >COD 


4? 


(The space before 0074 is intentional.) 


(The space before credit is intentional.) 


(continued) 


ee ee ee | 


ce ee ee 


Jjordy43d73d1d gf 


Inout Document 


<last?>Brindel 
<firstsRobert 
<add?159 Colby Street 
<citysNashua 
<state>NH 

€zip?O03063 
<item#>3009 

ftunit Prices$20,00 
<Paymt?cash 

<>} 


<lastsEmery 
&efirst?Charles 
€add?6G08 Knoll Road 
“citysManchester 
“<state>NH 
€z1ip?03101 
<item#?/008 

<tunit Price?+125,00 
<Paymtecredit 


«} 

<last>Maclean 
<first?Roxanne 
€<add?>3708 Loam Avenue 
<coitysAnaheim 
<state+CA 
£<Z1P292B803 
<1ltem#>8976 

fiunit Price+235,.00 
<Paymt >COD 

<> 


File the Customer List Input Document. 


Print it. You will sort this list in another exercise. You can com- 
pare this printed document with the sorted lists. 
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sort Specification Document 


To Create a Sort Specification: 


1 Select Create (C) from the Main Menu. 
2 Name the document. 
3 Type the sort field(s)/key(s) and the sort order(s). 


4 File the document. 


In the sort specification document, specify how you want the input docu- 
ment sorted. The sort specification has: 


e The name(s) of the field(s) to be sorted 


e The sort order for each key — ascending or descending 


The sort order is either an ascending order (same order as the Sort Alpha- 
bet) or a descending order (reverse order of the Sort Alphabet). 
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Sort Specification Document 


When you create sort specifications: 


e Use either uppercase or lowercase letters. 


e Type field names exactly as they appear in the input document. 


Single-Key Sort 


In Single-Key Sort, you specify one sort field/key and one sort order. It is a 
one-line document, like these: 


Format 1: 

SORT ON <field name? IN ASCENDING ORDER 
OR 

Format 2: 


SORT ON <field name? IN DESCENDING ORDER 


Figure 6 Single-Key Sort Specification Formats 


Multikey Sort 


In Multikey Sort, you can specify as many as 12 keys and more than one 
order. It is more than a one-line document. The first field/key named is 
called the primary key. Use the primary key to specify the order of the out- 
put document. 


If Sort is to list states and cities in either ascending or descending order, 
make <state> the primary key because state is a larger unit than city. 
Then, specify <city> as the second field. Sort organizes the cities within 
the larger category, states. If you want to sort streets as well, make 
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~— sort Specification Document 


<street> the third field. A street is a smaller unit than both a city and a 
al state. Organize fields for sort specifications so that larger units come before 
smaller ones; the largest unit sorted should be the primary key. 


The multikey sort specification shown in Figure 7 is organized this way. 
_ Note the word and at the end of a line when there is more than one 
statement. 
| Format: 
SORT ON <field name> IN ASCENDING ORDER and 
on SORT ON <field name> IN DESCENDING ORDER and 
al SORT ON <field name> IN ASCENDING ORDER 


Figure 7 Multikey Sort Specification Formats 


= Examples of Sorled Documenis 


When the input document is sorted, the first character of each field value 
for the specified field name is examined. The position of this first character 


oa in the Sort Alphabet determines the field value’s placement in the output 
document. If two field values begin with the same character, the second 
a character is examined, and so on. 
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sort Specification Document 


Example 1 


The following is an example of a list sorted in ascending order on two keys, 
<state> and <last>. Since <state> is the primary key, this key is sorted 
first. Then the key <last> is sorted. 


With this sort specification: 


SORT ON <state> IN ASCENDING ORDER AND 
SORT ON <last> IN ASCENDING ORDER 


This is how the output document will look: 


<last>Maclean 
(first7Roxanne 
<~co>Basics:s Ltd. 
fadd*3708 Loam Avenue 
<city Anaheim 
<state>CA 

€zips92803 
<cat#2F-H9850-EB 
epg#e 2G 

citem#e sBO7E 
<descrirpsSerial Interface Switch 
shipping wt>2 lbs. 
<runit Price>$2395.00 
<COD?>¥ 


£F 


(continued) 
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<last?Robertson 
<firstoWilliam 
<cooSurvivaorss Ines 
<add?910 Hedge Road 
{city>oCamebell 
<state>CA 

<zip>95008 
Ccat#oF-LOPK?Z-~SW 
<pg#719 

Citem#2A0076 
<descripzAcoustic Cover 
<shipring wt?>dO lbs. 
€tunit Price?425.00 
<COD?Y 


4K? 


<last>Brindel 


<first+Robert 
€<coreSpan Archs Ine, 
<add?159 Colby Street 
€city>Nashua . 
<state>NH 

<zipcso3o6s3 

<cat#>oF -HOBS0-RL 
“Pg#o27 

<item#>3009 
«descripoHP rulers - PKS. of 
<shipPing wts.03 lbs 
frunit Price>$20,00 
€cashvy 


<> 


<lastcEmery 
<firstoCharles 
<cor7ComPutaumations Ine. 
€<add?>GO8 Knoll Road 
<city>Manchester 
<state>NH 

€zirprsozial 
<cat#>F-~HOBS0-DA 
CPgH#>d0 

C<item#>/o0o08 
<descripsDECmat 4°x6’ 
{shipping wtdiO lbs. 
<sunit Price>125,.00 
4coredit>y 

<>? 


10 


sort Specification Document 


(continued) 
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sort Specification Document 


€lastsKadis 
“<first>Freeman 
<cozSine Qua 

fadd->1S55 Fourth Avenue 
“city Vestal 

<statesNny 

221P>138306 
CCaresF-LOPOLT-KA 
<PgH#S13 

Zitem#> 0074 
<descripoMylar Ribbon 
AShiPPing wtel Ib. 
Csunit Price?4d2.00 
<cashcy 

a 

<last>Sprell 
<firstzSarah 
<co>rProductions Ltd, 
faddsi75 Inwood Avenue 
tcoityeNy 

<staterNny 

<zips100ad4 
4cat#eF-HOB3S0-PH 
<pg#314 

Ziteme#sTOO7g 
(descripsFanfold Parer 
Cshipping wt227 lbs, 
Zeunit ePricesd3,o0 
<coreditey 


a 
Ne 


Figure 8 List Sorted on <state> and <last> in Ascending Order 
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sort Specification Document 


In the sorted list of records that follows (Figure 9), some item numbers 
<item#> start with letters, others with numbers, still others with symbols 
or spaces. Refer to the Sort Alphabet to see how Sort orders special symbols 


and numbers in ascending order. 


With this sort specification: 


SORT ON <item#> IN ASCENDING ORDER 


This is how the output document will look: 


tlastcRobertson 
<firstoeWilliam 
acosSurvivors: Ine. 
€add?7910 Hedge Road 
<city>Campbell 
“$tatesCA 

{Z1P298008 
<Gat#7F-LOPK2-SW 
<pg#e19 

<item#>A0076 
“descrip>Acoustic Cover 
<$hipeping wt?dO lbs. 
£sunit Price>425.G00 
<COD?Y 


’ 
~ P 


(continued) 
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<last?Spell 

“first Sarah 
<cosProductions Ltd, 
fadd?-i75 Inwood Avenue 
<cityony 

<staterzNy 

AzZip>10034 

L Cate 7F -HOSS0-—PH 
Apg#>1d 

<item#>TO074 
<descripsFanfold Paper 
“Shipping wt32?7 lbs. 
Ctunit Price?d3.00 
<oredite{ 


, om 
. 

3 

~~ 


<lasteKadis 

CfirstoF reeman 
Z~co7Sine Qua 

fadd>1i3S5 Fourth Avenue 
coitysVestal 

{state sNny 

<Zip2z1l3e8so 
<cat#oF-LOPOL-KA 
CPgH#e13 

<item#> 0074 
<descripsMyvlar Ribbon 
AShAiPPing wt?>l lk, 
Seunit Price 742,00 
Zcash>y¥ 


« 

wv, 

" 

gt 
» a 


<lastlvEmery 
afirstrCharles 


“co:Computaumations Ine, 


<addsGO08 Knoll Road 
“<CitysManchester 
<state>NH 

tZipso3idal 
<Gat#>F-HOBSO-DA 
CPg#IaAO 

<item#>/008 
“descrip>sDeECmat 4/6’ 
Shipping wt?310 Lbs, 
feunit pPrice>125,00 
<credit>y 


: 
an 
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<last>Brindel 
“first?Robert 
2co>Span Arch: Ine. 
£add7139 Colby Street 
fcity Nashua 

“state ?NH 

421P203063 

A0at#>oF -HOBSO-RL 
aPge>Z7 

<item#>3009 
Adescrip?WP rulers - PKs. of 10 
<SHIPPIing wt>,O5 Lbs 

Csunit Price>$20.00 


“cash: 
£> 
» @ 


“lastsMaclean 

first >Roxanne 
<co+Basics+ Ltd, 
<add>3708 Loam Avenue 
“clitysAnakheim 
“statesCa 

{Zzip792863 
{“cat#sF-HO8S50-EB 
4pg#>26 

<item#>B897G 
<descripsSerial Interface Switch 
<ShippPping wt>Z lbs, 
ffunNit Prices$235.00 
<COD?¥ 


<? 


Figure 9 List Sorted on <item#> in Ascending Order 
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Sort Specification Document 


Example 3 


In the following example, the list is sorted on two keys. The primary key is 
<paymt> and the sort is descending. The secondary key is <last> and the 
sort is ascending. 


Look at the first two records in the list. The blank space between <paymt> 
and credit brings that record to the beginning of the list. (See the Sort 
Alphabet on page 4.) According to the sort specification, Emery should 
come before Spell. But, the primary key is <paymt>, and that takes pre- 
cedence over the second key. 


With this sort specification: 


SORT ON <paymt?> IN DESCENDING ORDER AND 
SORT ON ¢<last?> IN ASCENDING ORDER 


This is how the output document will look: 


<last?>Spell 
<firstsSarah 

co Productions Ltd, 
fadd7175 Inwood Avenue 
<coity>sNny 

“state sony 

<ZiPps1lo00gag 
«cat#eF-HSBS0~-PH 
epg#71d 

Citem#?TAo7d 
tdescriptFanfold Paper 
<$hiPPing wt227 lbs, 
feunit pPrice?d3,a0 
<Paymt?> credit 

<> 


32 


J 


y.3 79 39 9 39 7 3 


1 4 


Se 


y§ 


<lastzEmery 
afirstsCharles 
<cosComrPutaumations Ine- 
Sadd>608 Knoll Road 
aOltysManchester 
“state>NH 

SZiP>03101 
<cat#?F-HOB50-DA 
CPg# 2 d0 

Zitem#:/OQ08 
Adeserip?>DECmat 4’xG’ 
<shipPing wt!1O lbs, 
Sfunit ePrice>12?5,00 
<Paymtocredit 


: 
ay 


<last-Maclean 

“first Roxanne 
<cosBasicss Ltd, 
Sadd>3708 Loam Avenue 
{citvyrAnaheim 
“statecCA 

AZip?92803 
<cat#sF-H9O8S0-EB 

CP g#226 

sitem#?8976 
Adescrip?>Serial Interface 
SShirPrPing wte2 Lbs, 
Lsunit Price +$235,00 
<Paymt+COD 

ue 


5 
» 


€last>Robertson 
“afirst?William 
<corSurvivors:s Inc, 
Sadd?:910 Hedge Road 
“oity?Campbell 
<state:CA 

Cz1lPp 295008 
“cat#oF-LOPK2Z-SW 
ApPy#OLG 

<item#sAGO76 
“descripr>Acoustic Cover 
{Shipping wt?24dO0 Lbs, 
ffunit Prices423,00 
<Paymt>COD 


fos 
~~ 7 


Switch 


Sort Specification Document 


(continued) 
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€last>Brindel 
“first>Robert 


<corSepan Archs Inc. 
tadd?159 Colby Street 
feityeNashua 
<$tate>NH 

£ZiP203063 
{Cat#>F-HOBSO-RL 
SPgHI!7 

fitem#?7 3009 
SdescripoWP rulers - pK, 
<ShipPing wts>.03 Lbs 
Ceunit Prices$Z20.00 


<Paymtscash 
“> 


<lasteoKadis 
CfirstoFreeman 


<corSine Qua 

Sadd?155 Fourth Avenue 
<city?Vestal 
{staterNy 

£2Z1ipP?713G850 
CCAatL#>F-LOQPOL-KA 
{Pg#>13 

fiteme> 0074 
“~descrip?Mylar Ribbon 
ZShipPing wt1i lb. 
Ceunit price?42,00 


<Paymt>cash 
<> 


Figure 10 List Sorted on <paymft> in Descending Order and <last> 


of 19 


in Ascending Order 
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Example 4 


The following figure uses a numeric field. The list is arranged in descending 
order according to the numeric value of the <:unit price> field. 


With this sort specification: 


SORT ON ¢<sunit price? IN DESCENDING ORDER 


This is how the output document will look: 


<lastzRobertson 
<firstoWilliam 
<corSurvivorss Ine. 
fadd>+910 Hedge Road 
ecity>Camebell 
<staterCAa 

€{z21p795008 

qc at#eF-LOQPX2S-Sh 
Cpgy#ee19 

<item#2A007G6 
édescripsAcoustic Cover 
<shipring wt>d0 lbs, 
ftunit Price+425.,00 
é~paymt >COD 

<> 


“~last Maclean 

€firstsRoxanne 

<corBasics:+ Ltd, 

<add>3708 Loam Avenue 

<eity 7Anaheim 

<state sla 

<Z2ip>9Z2B03 

Ccate#eF-HOB5S0-EB 

CPg#>SG 

<item#>8976 

<descripoSerial Interface Switch 
SSHLiPPing wt?2 lbs. 

Crunit Price>$235.00 

Zpaymt 7COD 

<> (continued) 
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<lastoEme ry 
afirstzCharles 
corsComputaumations Ine; 
@adds608 Knoll Road 
Solty >}Manchester 
<state>NH 

ZiP 70910) 
foat#>F-HO850-DA 
Cpg#>do 

fitem#>/OO8 
<descripsDECmat &’x6’ 
{shipping wteiOo ibs. 
feunit Prices1i25,00 
CPaymt dcaredit 


<> 


<lasteSpell 
<firstsSarah 
Zco07Production:s Ltd, 
“add>175 Inwood Avenue 
coeity ony 

“gtateoNy 

£21iPp710034 
<cat#>F~HO850-PH 
fpg#714 

Sitem#sTOO74 
idascriperanfold Paper 
“Shipping wte27 lbs, 
ffunit Price?+4d3.00 
CPaymtoaredit 


<> 


St oe 


<lastdKadis 

Cfirst7F reeman 
Z4coa7Sine Qua 

fadd?iSS Fourth Averue 
<city Vestal 7 
estate rsNny a 
<ziep?13sso 

<cat#F-LOPOL-KA ae 
¢pg#313 

Zitem#> 0074 aa 
CdescripeMylar Ribbon 

<ShiPPing wtai lb, - 
dtunit Price?d2.00 | 


<Paymt -cash | ad 
<2 
— 


(continued) 
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ClastoBrindel 
<first?Robert 
2co>Span Arch: Inc. 
<addsiS9 Colby Street 
<clity7Nashua 
{state?NH 

{ziPsQ3063 
<cat#eF-HOBSO-RL 
“PgR? 27 

Citeme?Goog 
édescriepsWP rulers - pKa, of 10 
{shipping wt?,.05 lbs 
{runit Price?$20.00 
{rPaymtocash 


£ sy 
y 


Figure 11 List Sorted on <:unit price> in Descending Order 


Exercise 2: Create Sort Specifications 


In this exercise you will create four sort specifications. Complete the 


Customer List input document from Exercise 1 before you start this exercise. 


Add these specifications to the same diskette you used in Exercise 1. 


1 Create a document and name it State Spec. Type a sort specifica- 
tion to produce a sorted list with states from lowest to highest val- 
ues and zip codes from highest to lowest values, according to the 


Sort Alphabet. 


File the document. 


2 Create another document and name it Numeric Spec. Type a sort 
specification to produce a sorted list with numeric fields from high- 


est to lowest values, according to the Sort Alphabet. 


File the document. 


3 Create a third document and name it Item Spec. Type a sort specifi- 
cation to produce a sorted list with item numbers from lowest to 


highest values, according to the Sort Alphabet. 


File the document. 


Sort Specification Document 


4 Create a fourth document and name it Payment Spec. Type a sort 
specification to produce a sorted list with payment from highest to 
lowest, and last names from highest to lowest values, according to 
the Sort Alphabet. 


File the document. 
These sort specifications will be used when we run Sort (Chapter 5). 


Solutions to Exercise 2 


Type the specifications in uppercase or lowercase letters. If you’d like, put 
an extra blank line in specifications with more than one sort key. The field 
name must be typed exactly as it appears in the input document. 


1 Sort on <state> in ascending order and 
Sort on <zip? in descending order 


2 Sort on “<tunit price? in descending order 
3 Sort on <item#> in ascending order 


4 Sort on <paymt> in descending order and 
Sort on ¢<last? in descending order 
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Running Sort 


To Run Sort: 


1 Type SR from the Main Menu. 

2 Type the name of the sort specification document. 
3 Type the name of the input document. 

4 Type the name of the output document. 


5 Type GO to begin Sort. 


Sort Documents 


Use three documents to run Sort: 


e An input document (list to be sorted). 


e A sort specification document (operator’s instructions to DECmate on 
how to sort). 


e An output document (list after it is sorted). 
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Running Sort 


Complete the input and sort specification documents before selecting the 
Sort option (SR) from the Main Menu. The sort specification does not need 
to be on the same diskette as the input document. It can be on a diskette in 
any drive on the system. If you have a two-drive system, the sort specifica- 
tion can be on the system diskette. 


The output document does not need to be ready before selecting SR. When 
Sort asks for the name of the output document, you can: 


e Give the name of a document that already exists (the sorted 
material is put into this document). 


e Give the new name to the document that you are creating with Sort. 


Beginning the Sort Process 


The diskettes in the drives should contain the input and sort specification 
documents. Write down the document names or numbers for both these doc- 
uments. You cannot run Sort if the printer is busy. At the Main Menu, type 
SR and press RETURN. 


Sort Specification 
The first display requests the name of the sort specification. (See Figure 12.) 


Figure 12 Display Requesting the Sort Specification 
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Running Sort 


When this display appears, type in the name or number of the specification 
document. If an incorrect name or number has been typed or the specifica- 
tion is not on a diskette in any of the drives, DECmate cannot locate the 
sort specification. The screen displays an error message. 


When the document name is correct, the system examines the sort specifica- 
tion for errors. If it finds an error, the screen displays an error message. A 
caret (*) points to the specific error. (See Figures 13 and 14 for sample error 
displays.) 


--SORT-- 


SORT ON <city?> IN ASCB 


ERROR--srpecification not understood starting at this Point, 


Press Gold MENU to recall the Main Menu. 


Figure 13 Sort Specification Error 


A’ 


Running Sort 


If the error occurs after the word order, DECmate tries to use the informa- 
tion up to the error. In this case, a message similar to the one in Figure 14 
appears. 


=-SURT-- 
SORT ON <zir? IN ASCENDING ORDER AND 


SORT ON «state? IN ASCENDING ORDER AND 
SORT ON ¢citys IN ASCENDING ORDER T 


3 field names have been specified. Text following the 
last complete Key specification will be ignored, 
Press RETURN to continue. 


OR Press Gold MENU to recall the Main Menu, 


Figure 14 __— Error After Key Specification ls Complete 


In Figure 14, the error occurs after the word order in the third key specifica- 
tion. There are three complete specifications and zip, state, and city will be 
sorted. If the error in the third key specification had occurred in the word 
ascending, there would have been only two complete key specifications. (The 
caret (“) would have appeared at the misspelled character in the word or 
words before order.) 


When an error has been identified, end Sort by typing Gold MENU. Correct 
and file the specification document. Select SR from the Main Menu and run 
Sort again. 
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Running Sort 


Inout Document 


If the sort specification is correct, you see a display, shown in Figure 15, 
asking for the name of the input document. 


--SORT-- 


Type the name of the input document you want to sort. 


And Press RETURN, 


OR Press Gold MENU to recall the Main Menu, 


Figure 15 Display Requesting the Input Document 
The input document must be on a diskette in a drive on your system. If an 


incorrect name or number was entered, or if there is no such document, an 
error message appears on the DECmate terminal screen. 
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Running Sort 


Output Document 


After the input document has been correctly named, the system requests the 
name of the output document (Figure 16). 


To create a new output document, type its name when you see this display 
(DECmate will create the output document automatically): 


Figure 16 Display Requesting the Output Document 
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Running Sort 


If a document with the same name already exists, and you want to add the 
sorted records to it, you see the display in Figure 17. 


--SORT -- 


Document already exists, 
How would you like the document modified? 


T = Add text to the top 
B = Add text to the bottom 
0 = OQverwrite the document 


Type the letter and Press RETURN. 


OR Press Gold MENU to recall the Main Menu, 


Figure 17. Menu to Modify Output Document 


Modify the document by making a selection from the menu. Be sure the 
diskette containing the output document has enough blocks remaining to 
store the newly sorted output document. See page 48. 


AS 


Running Sort 


Confirming Sort Document Names 


After you specify the output document, the screen changes. A display with 
the names of the three sort documents appears. See Figure 18. 


Check that the document information is correct. The abbreviation (d.nn) 
after each document stands for diskette drive and document number; name 
means the name given to each document. The abbreviation (nn) before Key 
Sort tells the number of keys being sorted. 


-=-=-SORT-- 
Input document: (d.nn) name 
Using sort specification documentation: (d.nn) name 


The sorted document will be stored in: (d.nn) name 
(nn) Key Sort 


Type GO to begin Sort 
And Press RETURN, 


OR Press Gold MENU to recall the Main Menu, 


Figure 18 Display Confirming Sort Documents 


If you want to change the input document, the specification document, or 
the output document, press Gold MENU. Sort stops. To start Sort again, 
select SR from the Main Menu. 


To run Sort, type GO and press RETURN. 
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Running Sort 


sorting a List 
When Sort begins, working appears on the screen. 


While Sort is in progress, the input document is checked for conditions that 
may affect the output document. A message appears on the screen, identify- 
ing the conditions that may interfere with the Sort process. See Chapter 6 
for a complete list of messages. 


NOTE: To stop the Sort process—at any time—press Gold HALT. 


When Sort is complete (Figure 19), you see this additional information on 
the display: 


e The number of Primary Key Records. The first number is a running 
tally of records with the first sort field. The second number is the 
total number of records in the input document. 


e The number of Records Reproduced. This number should match the 
total number of records in the input document. 


e Done. This tells you Sort is completed. 


Figure 19 Sort Completed Display 


To run Sort again, return to the Main Menu and select SR. 


4/7 


Running Sort 


Stopping Sort 


To stop Sort at any time, press Gold HALT. Pressing Gold HALT replaces 
working with paused on the display. You may either cancel or continue the 
Sort. 


To cancel Sort, press Gold MENU. 
To continue Sort, press RETURN. 


Output Document Messages 


Size of Output Document 


The diskette that is going to receive the output document must have enough 
room to receive the sorted input document. If the diskette doesn’t have at 
least 16 more blocks than the number of blocks in ue input document, use 
another diskette. 


To be sure of using the right diskette for the output document: 


1 Check the index of the input document’s diskette. Make a note of 
the number of blocks in the input document. 


2 Check the index of the output document diskette. Make sure that 
there are at least 16 more blocks on that diskette. 


If you haven’t followed this procedure and the output document diskette 
doesn’t have enough room to receive the sorted input document, your 
DECmate displays one of these three screens: 


e The display in Figure 20 tells you to select a diskette on a different 
drive for your output document. 
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Figure 20 Display Requesting a Different Diskette Drive 
e Ifthe system diskette was selected, and it does not have enough 


room, Sort asks to replace the system diskette with a document 
diskette. The message in Figure 21 appears: 


Figure 21 Display Requesting a Document Diskette in Drive 0 
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e Ona two-drive system, if the input document is on the system disk- 
ette (drive 0) and the document diskette in drive 1 is full, then the 
display in Figure 22 appears: 


We 8 
lable s 


Figure 22 Display Requesting Replacement of Full Diskette 
with Another Document Diskette 


e Instead of selecting different drives or diskettes, delete documents 
that you don’t need. Remember to delete enough documents to pro- 
vide the blocks needed for the output document. 
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Table 1. What to Do in a Two-Drive System 
When an Output Document Will Not Fit 


Drive # with Drive # with 
Input Document Output Document Action to Be Taken 

0 0 Specify another drive. (Drive 1) See 
Figure 20. 

0 1 Replace document diskette in drive 1. 
See Figure 22. 

1 0 Replace system diskette in drive 0. 
See Figure 21. 

1 1 Specify another drive. (Drive 0) See 


Figure 20. 


Additional Output Document Messages 


When you are creating an output document on a diskette that contains 200 
documents, the message in Figure 23 appears: 


--SORT-- 


Unable to create document. 
There are no more documents available, 


Press RETURN to try another name, 


OR Press Gold MENU to recall the Main Menu, 


Figure 23. Output Document Diskette Is Full 


of 


Running Sort 


Press RETURN to try a document name that already exists or cancel Sort 
and return to the Main Menu. 


When creating an output document by number AND that number is larger 
than 200, the message in Figure 24 appears: 


--SORT-- 


Unable to create document, 
Document numbers must be from 1 to 200, 


Press RETURN to try another name, 


Or Press Gold MENU to recall the Main Menu. 


Figure 24 Incormect Output Document Number 
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The message in Figure 25 appears when you have selected the wrong disk- 
ette to receive the sorted list. (Examples of wrong diskettes are optional 
feature diskettes and diskettes that are not initialized.) 


--SORT-- 


The diskette in drive (d) is not a valid document diskette, 
Replace it with a document diskette, 


And Press RETURN, 


Or Press Gold MENU to recall the Main Menu, 


Figure 25 Diskette to Receive Output Document Is Not Valid 


The message in Figure 26 appears when the output document diskette in 
drive 0 is not valid. (A diskette that is not initialized is not valid.) 


--SORT-- 


The diskette in drive 0 is not a valid document diskette, 
Replace it with a document diskette, 


And Press RETURN, 
OR Replace the system diskette in drive 0, 
AND Press Gold MENU to recall the Main Menu, 


Figure 26 Document Diskette in Drive 0 Is Not Valid 


53 


Running Sort 


Exercise 3: Running Sort 


When you have completed Exercises 1 and 2, sort the Customer List. Use 
the diskette that has the list and the four selection specification documents. 


1 
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Check the diskette index and note the number or name of the 
Customer List and the State Spec. Do the following and follow the 
prompts where necessary: 


Type SR from the Main Menu and then press RETURN. 

Type the name or number of the sort specification. Press RETURN. 
Type the name or number of the input document. Press RETURN. 
Type the name or number of the output document. Press RETURN. 
Type GO to begin Sort. 

Go back to the Main Menu. 

Print your output document. 


Repeat these eight steps for the other three specifications. Use a different 
sort specification each time you run Sort. If you named the sort specifica- 
tions according to the instructions in Exercise 2, they are: 


Numeric Spec 
Item Spec 
Payment Spec 
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Output Results 


4 Running Sort with the State Spec, the output document should look 
like the following: 


<last>Robertson 
CfirsteWilliam 
<add?910 Hedge Road 
<citysCampbell 
<state+CA 
€z1p?95008 
C<item#>A0076 

<sunit Price s425.00 
<Paymt *COD 


™ 
4? 


<last>Maclean 
<first?Roxanne 
€add?>3708 Loam Avenue 
CcitysAnaheim 
€state+CA 

€zZzip?92B803 
<item#>8976 

Crunit Price>$2Z235.00 
<paymt>COD 

<> 


<lastsEmery 
«first?>Charles 
€<add>6G08 Knoll Road 
€city>Manchester 
<state*NH 
<zZziP+>O3i0l 
<item#>/008 

<iunit Price+125.00 
<Payintscredit 

<> 


(continued) 
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<last?Brindel 
¢first?Robert 
¢add>159 Colby Street 
<city>Nashua 
<state>NH 

<zip?03063 
<item#>3009 

€runit Price?$20,00 
<Paymtecash 

«> 


€lasteKadis 
<first?>F reeman 


€add?155 Fourth Avenue 


<citysVestal 
<staterNny 
€Zip?13850 

Citem#> O074 
<sunit Price>42,00 
<Paymtscash 

<> 


’ 


<last?Spell 
<first>Sarah 


fadd?>175 Inwood Avenue 


city ony 

€staterNy 
€zip>+10034 
Citem#>TO074 
Crunit Price>d3,.00 
ePaymt? credit 

<> 


14 


4 


J 


1 
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§ 
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look like the following: 


<last>Robertson 
<firstoWilliam 
<add>910 Hedge Road 
<city?Campbell 
<state?rCA 
€<Z1P>95008 
Citem#>AQO7E 

ftunit Price+425,00 
<Paymt COD 

<> 


<last?>Maclean 
<first?Roxanne 
<add>3708 Loam Avenue 
<citysAnaheim 
<statesCA 

€zip?92803 
<item#>8976 

<sunit Price?$235,00 
<Paymt>COD 

<q > 

€lastsEmery 
<first>Charles 
<add>G0O8 Knoll Road 
<citysManchester 
<state>NH 

€ZiPpsO31o0l 
<item#>/008 

frunit Price?125.00 
CPaymtscredit 

<> 


€<last?>Spell 
<first?>Sarah 

€add>175 Inwood Avenue 
f<citysNy 

<staterNy 

€zZz1p>10034 
Citem#>TO074 

<tunit Price?43.00 
<Paymt? credit 


- 


<> 
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2 Running Sort with the Numeric Spec, the output document should 


(continued) 
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<lasteKadis 
<first>Freeman 
¢add?155 Fourth Avenue 
<city?Vestal 

€statesNy 

¢€zip?13850 

<item#> 0074 

Ceunit Price+d2.00 


? 


<Paymt>cash 


by 
? 


a 


<last-Brindel 
éfirsteRobert 
€add-159 Colby Street 
<citysNashua 
<state>NH 

<Z1iPp?>03063 
C<item#>3009 

<runit Price s$2Z20,00 
<Paymt>cash 


< 


<> 


J 
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Running Sort with the Item Spec, the output document should look 


like the following: 


<last?Robertson 
<firsteWilliam 
<add?910 Hedge Road 
<citysCampbell 
<state>CA 
€zip>95008 
<item#>AQ07G 

ftunit Price s425,.00 
<Paymt >COD 

<> 


<last?>Spell 
<first>Sarah 

f<add?>175 Inwood Avenue 
€cityoNny 

<staterNy 

<zZzip?>100g4 
<item#>TOO74 

frunit Price+43,00 
<Paymt? credit 
<> 


¢lastoKadis 
efirst>?Freeman 
€add?>155 Fourth Avenue 
fclty>sVestal 

<state Ny 

€zZip3s13850 

<item#> O074 

<tunit Price?:42,00 
<Payrmt cash 

of 


o 


a 


<lasteEmery 
<first>Charles 
<add>GO08 Knoll Road 
<cityeManchester 
<§tate>NH 
£Z1P>03101 
Citem#>/008 

ftunit Prices125.00 
CPayintocredit 

<> 


(continued) 
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<last?Brindel 
€first>Robert 
€add?159 Colby Street 
<citysNashua 
<state>NH 

€zip>O03063 
<item#>300g 

Crunit Price>+$20,00 
<Paymt?cash 

<> 


<last>Maclean 
<first>Roxanne 
€<add?3708 Loam Avenue 
<citysAnaheim 
<state+>CA 

€zip+92803 
<item#>8976 

Csunit Price+$235.00 
<Paymt?>COD 

<> 


J 


dt 


1) 


look like the following: 


€last?Spell 
<first?Sarah 

€add?175 Inwood Avenue 
{city NY 

<state>Ny 

€zip?10034 
C€item#>TO074 

{runit Price?43,00 
<Paymt? credit 

<> 


<lastrEmery 
<first?Charles 
<add>G0O8 Knoll Road 
<citysManchester 
<state>NH 
€zZ1P?+03101 
<item#>/008 

<sunit Price?125.00 
<Paymtccredit 


Fa 
*, PS 


<last?Robertson 
<first?eWilliam 
fadd>910 Hedge Road 
<city>Campbell 
<state+CA - 
<Z1P?395008 
<item#>A0076 

frunit Prices425,00 
<Ppaymt+?COD 

<> 

€last>Maclean 
<first?>Roxanne 
f<add?3708 Loam Avenue 
<oilty>sAnaheim 
<state>+Ca 

€Zip?92803 
éitem#>B8976 

f€funit Price?$235,.00 
<Paymt -COD 


fo} 
ot 
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4 Running Sort with the Payment Spec, the output document should 


(continued) 
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€<last>Kadis 
<first?>Freeman 
€add?>155 Fourth Avenue 
<city>Vestal 

<statesNy 

{zip?13850 

<item#> 0074 

¢runit Price+42,.00 
<Paymt>scash 

<>} 


¢last?>Brindel 
<first?eRobert 
f<add?159 Colby Street 
fcity?>Nashua 
<state>NH 

£zip?03063 
<item#>3009 

Crunit Prices$2Z20,00 
<Paymt>cash 


s 
SF 


7 


3 


J 


4 


J 


Se | 


; ie 


6 


screen Messages 


DECmate displays screen messages to help you complete Sort correctly. 


Inout Document Errors 


An incorrect format of the input document causes error messages. To sort 
records correctly, the input document must follow the format described in 
Chapter 3. If the input document is not in that format, DECmate II displays 
an error message. 
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Figure 27 is an example of an input document error message. 


Figure 27. An Input Document Error Message 


NOTE: The first seven lines of the input document record are displayed. The 
error, itself, may not appear in these lines. The purpose of the message is to 
identify the record containing the error. 


A list of input document error messages with instructions on what to do 
follows: 


ERROR--Record exceeds 2500 characters 


1 Note the record containing too many characters. 


2 Press Gold MENU to cancel Sort. When the Main Menu is dis- 
played, select E to edit the input document. 


3 Edit the record so that it contains fewer than 2500 characters. 
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_ 4 File the input document. 

_ 5 Select SR to start Sort over from the beginning. 

pen ERROR--Field name missing ’<’ or text between records 

ae 1 Note the record with the missing left angle bracket < or the text 

between records. 

= 2 Press Gold MENU to cancel Sort. When the Main Menu is dis- 
played, select E to edit the input document. 


3 Edit the field name by putting in a left angle bracket <. Or, delete 
text between records. 


= 4 File the input document. 


5 Select SR to start Sort over from the beginning. 


Bos ERROR--Field name contains extra ‘4’ 

= 1 Note the record containing the extra left angle bracket <. 

ai 2 Press Gold MENU to cancel Sort. When the Main Menu is dis- 

_ played, select E to edit the input document. 

- 3 Delete the extra left angle bracket <. 
7 4 File the input document. 
| 5 Select SR to start Sort over from the beginning. 

eae, 

is ERROR--Field name exceeds 30 characters 

ie 1 Note the record containing the field name with too many 

characters. 

si 2 Press Gold MENU to cancel Sort. When the Main Menu is dis- 
played, select E to edit the input document. 

: 3 Edit the field name to not more than 30 characters. 
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Screen Messages 


4 File the input document. 


5 Edit the sort specification document. Make sure the field name in 
the sort specification and the input documents are the same. File 
the sort specification document. 


6 Select SR to start Sort over from the beginning. 


ERROR--Key value field contains ‘’?’ 


1 Note the record containing the field value with the right angle 
bracket >. 


2 Press Gold MENU to cancel Sort. When the Main Menu is dis- 
played, select E to edit the input document. 


3 Delete the right angle bracket > from the field value. 
4 File the input document. 


5 Select SR to start Sort over from the beginning. 


ERROR--Record contains duplicate Key 


1 Note the record containing the duplicate key (field name). 


2 Press Gold MENU to cancel Sort. When the Main Menu is dis- 
played, select E to edit the input document. 


3 Delete the duplicate key (field name). 
4 File the input document. 


5 Select SR to start Sort over from the beginning. 


ERROR--List not terminated ‘’¢>° 


4 Press Gold MENU to cancel Sort. 


2 Edit the input document when the Main Menu is displayed. 
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3 Add a diamond <> to end the list of records. 
4 File the input document. 


5 Select SR to start Sort over from the beginning. 


ERROR--Unexpected end of file 


Explanation: This message appears when the data on the input document 


diskette cannot be read (diskette damaged or dirty). 


4 Press Gold MENU to cancel Sort. 


2 Verify document diskette. If the diskette has errors, follow the 
prompts. 


3 Select SR to start Sort over from the beginning. 
ERROR--List contains only text 


1 Press Gold MENU to cancel Sort. 
2 Edit the input document when the Main Menu is displayed. 


3 Add left < and right > angle brackets to field names. Add 
diamonds <> to end of records. 


4 File the input document. 


5 Select SR from the Main Menu to start Sort from the beginning. 


ERROR--Primary Key not found 


Explanation: The first sort field named in the sort specification does not 
match any field names in the records of the input document. 


4 Press Gold MENU to cancel Sort. 


2 When the Main Menu is displayed, edit the field names in the 
input document. 


3 File the input document. 
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Screen Messages 


4 Kdit the sort specification. Make sure the field names in the input 
and sort specification documents are identical. 


5 File the sort specification. 


6 Select SR to start Sort over from the beginning. 


ERROR--Invalid numeric syntax 


Explanation: The rules for numeric field values have not been followed. 
For example, an invalid character, such as a letter, is in the field value; or a 
valid symbol such as + is in the wrong place. 


1 Press Gold MENU to stop Sort. 


2 Edit the input document when the Main Menu is displayed. Check 
the numeric field and make sure the field values are correct. 


3 File the input document. 


4 Select SR to start Sort over from the beginning. 


Warning - List contains multiple rulers 


The Sort will continue until complete, unless you can cancel the Sort 
process. To cancel Sort: 


1 Press Gold HALT to pause Sort and then press Gold MENU to 
cancel Sort. 


2 Edit the input document. 


3 Only one ruler can be in effect for the entire list of records. Remove 
the other rulers. (See page 18.) 
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Other Messages 


ERROR--Outeput diskette full 


Explanation: Sometimes Sort can’t determine the number of blocks needed 

for an output document. On rare occasions, while Sort is running, it will run 
out of diskette space before it has completed the output document. The input 
list document probably has too many records with blank or nonexistent field 
values. 


1 Press Gold MENU to cancel Sort. 

2 Use a new, initialized diskette for the output document. 
3 Select SR to start Sort over from the beginning. 
4 


If the error message appears again, edit the input document and 
type field values in the fields that do not have them. Or, edit the 
selection specification document and delete the sort field(s) with 

missing field values. Select SR again. 


If you have taken your system diskette out of its drive during Sort, this 
message appears on your screen: 


Replace system diskettes then 
Press Gold MENU to recall the Main Menu. 


See Chapter 5 for output document messages. 
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Glossary 


Italicized words are also entries in the glossary. 


activate 


To add an optional feature, such as Sort, on the system diskette. 


ascending order 


According to the Sort Alphabet, ascending order is from lowest value 
characters to highest value characters. 


block 


A text storage unit on a diskette with about 512 characters or approxi- 
mately one-third of a page. 


7\ 


Glossary 


descending order 
According to the Sort Alphabet, descending order is from highest value 
characters to lowest value characters. 

diamond 


The symbol < > used to mark the end of a record. 


empty field 


A field that has a field name (key), but no field value. 


error message 


A screen message that is automatically displayed when an incorrect 


response is typed. It explains the problem and tells you what to do next. 


feature diskette 


The diskette used to activate an optional feature. 


field 


One of the units of information in a record. A field is identified by a 
field name and a field value. For example, a field name could be 
<company> and its value Digital Equipment Corporation. 


field name 
The part of the field that identifies the information you will sort. The 


field name is always enclosed in angle brackets and is followed by a 
field value. See key. 
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Glossary 


field value 


The part of the field that has the information that is associated with the 
field name. The characters are placed right after the right angle bracket 
that ends a field name. 


file 


The data in a document. 


highest value 


The last character in the Sort Alphabet. 


input document 


A list of records to be sorted. 


invisible characters 


A character that is not visible except in the view mode. 


key 


A field name, as defined in the sort specification, on which the sort 
process operates. 


key sort 
Information on a Sort display that tells how many fields or keys you are 


sorting with. 


lowest value 


The first character in the Sort Alphabet. 
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missing field 


A field that appears in some but not all of the records in the input 
document. 


multikey sort 


Sorting records on more than one key or field. 


numeric field 


A field with a field name that begins with a: and has a field value that 
is numeric. For example, <:number>25.00. 


optional feature 


Software that can be added to the word processing basic software. Sort 
is an optional feature. 


output document 


The document that contains the results of the Sort process. 


primary key 


The first sort field or key named in the sort specification document. 


record 


A group of related fields in an input document. A record consists of field 
names and field values and a diamond to mark the end of the record. 


single-key sort 


Sorting records on one key or field. 
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Glossary 


Sort Alphabet 


The 62 characters used in sorting a list. The characters are arranged in 
ascending order. 


sort field 


The field in the record on which you want to sort. The field is put in the 
sort specification document. 


sort key 


See sort field. 


sort order 
Either an ascending or a descending arrangement of records in the input 
document. The order is determined by the sort specification. 

sort specification document 


Determines the sort fields and the order of the sorted list. 
valid 


A character or diskette that is appropriate for the task. For example, — 
is a valid character for a numeric field. 
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A 

Activating Sort, 5 to 8 

Ascending order 
description of, 2, 3, 23 
specifying, 24 


B 

Blank line 
between records, 11 
in specifications, 38 


Blocks of text 


remaining, 48 
used, 48 


C 

Canceling Sort, 48 

Comment, 18 to 19 

Control command markers, 18 


Cut-and-paste feature, 19 to 20 


D 


Descending order 


description of, 2, 3, 23 
specifying, 24 


Index 


Diamond 
in records, 11, 19 
Diskette 
feature, 5 
system, 5 
Documents 
input, 1, 2, 11 to 18 
output, 1, 2, 40, 44 to 45 
oversized, 48 to 51 
overwrite, 45 
sort specification, 23 to 25 


E 
Empty fields 
input document, 15 
output document, 16 
Error messages 
input document, 64 to 68 
invalid numeric syntax, 68 
on drive one, 9 
output diskette full, 69 
primary key, 67 
sort specification, 41 fo 42 
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F 
Feature diskette 
label, 5 
wrong diskette message, 9 
Field 
description of, 12 
empty, 15 fo 16 
missing, 15 to 16 
numeric, 16 fo 17 
Field names 
format for, 14 
numeric, 16 
in sort specification, 24, 25 
Field values 
empty, 15 
format, 15 fo 16 
invisible character in, 15 
numeric, 16 to 17 
File 
input document, 21 
sort specification, 23, 37, 38 


G 
Gold HALT, 47, 48 


H 


Hard return, see Blank line 


Input document 

control command markers, 
18 to 19 

create, 18, 19 
description of, 1, 2, 11, 19 
display requesting, 43 
edit, 18 
messages, see Messages 
print, 18, 21, 54 
records in, ‘11 
rulers in, 18 
running Sort, 39 
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Invalid diskettes 
document, 53 
feature, 9 

Invisible character 
in field value, 15 


K 
Key, see Field names 
Key Sort, 46 


L 


List document, see Input document 
List processing, 2, 9, 11, 16 


M 


Messages 
errors, see Error Messages 
invalid document diskette, 53 
invalid feature diskette, 9 
invalid output document, 53 
multiple rulers, 18, 68 
output diskette full, 48 to 51 
output document number 
over 200, 51 fo 52 
Missing field 
in input document, 15, 16 
in output document, 15 
Multikey Sort 
description of, 24 to 25 
examples, 26 to 28, 32 to 34 
specifying, 25 


N 


Numeric fields 
description of, 16 
difference between non-numeric, 
16, 17 
examples, 35 to 37 
field names, 16 
field values, 16 to 17 
input document error, 68 
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Numeric fields (Cont.) 


in List Processing, 16 

in Math, 16 

space in, 16 

valid characters, 16 to 17 


O 


Order, see Sort order 
Output document 
create, 44 
description of, 39 
display requesting, 44 
edit, 18 
modifying document, 45 
oversized document, 48 to 51 
print, 54 
running Sort, 39 
on two-drive system, 50 to 51 


P 
Primary key 

description of, 24 

error message, 67 

example, 26 to 28, 32 to 34 
Primary key record, 47 


Records 
creating, 11, 19 
description of, 41 
error messages, 64 to 68 
example, 12 to 14 
format, ‘11 
number of characters in, ‘11 
reproduced, 47 

Ruler 
in input document, 18 
number of, 18 
output document, 18 
warning, 18, 68 


Running Sort 

canceling, 48 

documents needed, 39 

input document errors, 43 

output document messages, 
44, 48 to 53 

Sort completed display, 47 

specification errors, 41 to 42 

stopping sort, 48 

summary of, 39 


Sort 
activate, 5 to 8 
running, 39 to 53 
stop, 48 
summary of, 1 
when to use, 2 

Sort alphabet, 4 

Sort field, 16 

Sort key, 16 

Sort, kinds of 
multikey, 24 to 25 
on numeric fields, 16 
single-key, 24 

Sort order 
alphabetic, 2 
ascending, 2, 3, 23 
descending, 2, 3, 23 
numeric, 2, 17 

Sort specification 
create, 23, 37 
description of, 23 
display requesting, 40 fo 41 
error messages, 41 to 42, 67 
examples, 26 to 29, 32, 35 
format, 24, 25 
multikey, 25 
placement of, 40 
primary key, 24, 26, 32 
running Sort, 39 
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Sort specification (Cont.) 

single-key, 24 

summary of, 23 
Spaces 

field values, 15 

numeric field values, 16 
Specification, see Sort specification 
System diskette 

label, 5 

replace message, 69 


T 
Tab 

in field values, 16 
Two-drive system, 40 
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HOW TO ORDER ADDITIONAL DOCUMENTATION 


DIRECT TELEPHONE ORDERS 


In Continental USA In Canada In New Hampshire, 
and Puerto Rico call 800-267-6146 Alaska or Hawaii 
call 800—258—1710 call 603—884—6660 


DIRECT MAIL ORDERS (U.S. and Puerto Rico’) 


DIGITAL EQUIPMENT CORPORATION 
P.O. Box CS2008 
Nashua, New Hampshire 03061 


DIRECT MAIL ORDERS (Canada) 


DIGITAL EQUIPMENT OF CANADA LTD. 
940 Belfast Road 
Ottawa, Ontario, Canada K1G 4C2 
Attn: A&SG Business Manager 


INTERNATIONAL 


DIGITAL EQUIPMENT CORPORATION 
A&SG Business Manager 
c/o Digital's local subsidiary 
or approved distributor 


Internal orders should be placed through the Software Distribution Center (SDC), Digital 
Equipment Corporation, Northboro, Massachusetts 01532 


“Any prepaid order from Puerto Rico must be placed 
with the Local Digital Subsidiary: 
809-754-7575 
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Reader's Comments 


Your comments and suggestions are welcome. They will help us in our contin- 
uous effort to improve the quality and usefulness of our publications. 


1 How would you rate this manual for: 
good fair poor 
completeness of information 
accuracy of information 
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a) Incorrect information: 
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things? 
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